UI.SetRgbLed

This command changes the RGB color of a single LED or a group of LEDs. The color may be activated instantly or smoothly by a sine-wave approximated fading transition.

If the addressed LEDs are already active when this command is called, the color first fades to black (off), before the transition to the new color starts.

This command gives you direct control of the reader's LEDs. It competes with the command UI.Enable, which can be used to switch LEDs via Virtual LED port definitions (VLEDs). UI.Enable operates on a higher abstraction level. Don't mix the 2 commands as this may result in inconsistent behavior.

Properties

Parameters (request frame)

Name Type/Size Description
LedState Bit mask (16 bits) A bitmask containing the physical LEDs you want to switch.
RFU Integer (bit mask area 0xFFF8) Zero padding
LeftLed Boolean (bit 0x0004)

LED(s) on the left side of the reader

On readers with only a single LED, this bit has no effect.
RightLed Boolean (bit 0x0002)

LED(s) on the right side of the reader

On readers with only a single LED, this bit has no effect.
SingleLed Boolean (bit 0x0001)

Single LED of the reader

On readers with 2 or more LEDs, this bit has no effect.
RgbColor Integer (32 bits) The target RGB color (0x00RRGGBB).
TransitionTime Integer (16 bits) The time for the fading transition to activate the target RGB color in ms. If a color is currently activated, this is also the time for the transition to deactivate this color first. For an immediate color activation, set the value to 0.

Returned values (response frame)

None